home *** CD-ROM | disk | FTP | other *** search
/ The Very Best of Atari Inside / The Very Best of Atari Inside 1.iso / mint / mintmant / fpipe.txt < prev    next >
Text File  |  1992-03-24  |  1KB  |  64 lines
  1. Fpipe(2)                  Oct. 1, 1991                   Fpipe(2)
  2.  
  3.  
  4.  
  5. NAME
  6.      Fpipe - create a pipe
  7.  
  8. SYNOPSIS
  9.      LONG Fpipe( WORD usrh[2] );
  10.  
  11. DESCRIPTION
  12.      Fpipe creates a pipe that may be used for interprocess  com-
  13.      munication.  If  it  is  successful,  two GEMDOS handles are
  14.      returned in usrh[0] and usrh[1]. usrh[0] will contain a han-
  15.      dle for the read end of the pipe, (opened for reading only),
  16.      and usrh[1] will contain a handle for the write end  of  the
  17.      pipe (opened for writing only).
  18.  
  19.      The created pipe has the name "sys$pipe.xxx", where "xxx" is
  20.      a three digit integer.
  21.  
  22. USAGE
  23.      Typically used by shells; the shell redirects  its  standard
  24.      input (or standard output) to the read (or write) end of the
  25.      pipe using Fdup and Fforce before  launching  a  child;  the
  26.      child will then read from (or write to) the pipe by default.
  27.  
  28. RETURNS
  29.      0 if successful
  30.  
  31.      ENHNDL if there are not 2 free handles to allocate  for  the
  32.      pipe
  33.  
  34.      ENSMEM if there is not enough free memory to create the pipe
  35.  
  36.      EACCDN if too many pipes already exist in the system
  37.  
  38. BUGS
  39.      There cannot be more than 999 open pipes in  the  system  at
  40.      one time.
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60. Version 0.9   Last change: MiNT Programmer's Manual             1
  61.  
  62.  
  63.  
  64.